Skip to content

docs: use the dynamic README header endpoint - #17

Open
AlemTuzlak wants to merge 2 commits into
mainfrom
readme-header-endpoint
Open

docs: use the dynamic README header endpoint#17
AlemTuzlak wants to merge 2 commits into
mainfrom
readme-header-endpoint

Conversation

@AlemTuzlak

@AlemTuzlak AlemTuzlak commented Aug 3, 2026

Copy link
Copy Markdown

Adopts the dynamic README header endpoint added in TanStack/tanstack.com#1076,
which is merged and live.

README banners now point a <picture> at https://tanstack.com/api/readme/
instead of a committed PNG. The endpoint renders 1800x450 in light and dark, so
a branding change lands in every README at once and dark-mode readers get a
dark banner.

What changed

  • README.md had no banner at all. It gets one now, for parity with the other library repos.
  • packages/template* (6 READMEs) pointed at ./media/header_template.png. This repo has no media/ directory, so those banners were broken. They now point at the endpoint.

Known limitation, deliberately not fixed here

The six packages/template* packages (@tanstack/template, @tanstack/react-template,
@tanstack/solid-template and their devtools) are leftover scaffolding from
TanStack/template, not real Workflow packages:

  • not listed in pnpm-workspace.yaml, so never installed, built, linted or typechecked
  • all still at version 0.0.0
  • all 404 on npm (compare @tanstack/workflow-core, which is published)
  • packages/template/src/hello.ts is the untouched template placeholder

The same is true of examples/react/* and examples/solid/*, which import them.

This PR only stops the images being broken - it does not remove the dead code.
Each of those six READMEs carries an HTML comment saying so, so the next person
who opens one is not misled. Removing the scaffolding is ~78 files across 10
directories plus one @tanstack/react-template badge in
.github/ISSUE_TEMPLATE/bug_report.yml; nothing else references any of it, so it
would be a self-contained cleanup whenever you want it.

Notes

  • Light and dark are served through <picture>, per GitHub's guidance. The trailing <img> stays the light variant, as the fallback for renderers that ignore <picture> (npm, most editors).
  • workflow accepts no ?framework= values on the site, so every banner here is the plain library banner.

Verification

All 21 URL occurrences across the 7 READMEs resolve to 2 distinct URLs, both
returning 200 image/png at 1800x450. git grep confirms no README still
references the missing media/header_template.png.

Summary by CodeRabbit

  • Documentation
    • Added centered, theme-aware TanStack Workflow banners to the main and package README files.
    • Updated banner descriptions, sizing, and responsive dark/light image sources.
    • Documented the leftover, unpublished scaffolding status of template packages.

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The README files now use responsive TanStack Workflow banners with separate dark and light image sources. Template package READMEs also document their leftover scaffolding status.

Changes

README theme-aware banners

Layer / File(s) Summary
Theme-aware banner rendering
README.md, packages/*/README.md
Replaces local template banners with remote TanStack Workflow artwork. Adds dark and light sources, updated alt text and dimensions, and scaffolding notes where applicable.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly states that README headers now use a dynamic endpoint, matching the main changes across the READMEs.
Description check ✅ Passed The description clearly explains the changes, motivation, scope, limitations, and verification, but it omits the template headings and checklist.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-header-endpoint

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

2 package(s) bumped directly, 6 bumped as dependents.

🟩 Patch bumps

Package Version Reason
@tanstack/workflow-core 0.0.4 → 0.0.5 Changeset
@tanstack/workflow-runtime 0.0.3 → 0.0.4 Changeset
@tanstack/workflow-cloudflare 0.0.3 → 0.0.4 Dependent
@tanstack/workflow-netlify 0.0.4 → 0.0.5 Dependent
@tanstack/workflow-railway 0.0.3 → 0.0.4 Dependent
@tanstack/workflow-store-cloudflare-d1 0.0.4 → 0.0.5 Dependent
@tanstack/workflow-store-drizzle-postgres 0.0.5 → 0.0.6 Dependent
@tanstack/workflow-vercel 0.0.4 → 0.0.5 Dependent

@pkg-pr-new

pkg-pr-new Bot commented Aug 3, 2026

Copy link
Copy Markdown
More templates

@tanstack/react-template

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/react-template@17

@tanstack/react-template-devtools

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/react-template-devtools@17

@tanstack/solid-template

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/solid-template@17

@tanstack/solid-template-devtools

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/solid-template-devtools@17

@tanstack/template

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/template@17

@tanstack/template-devtools

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/template-devtools@17

@tanstack/workflow-cloudflare

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-cloudflare@17

@tanstack/workflow-core

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-core@17

@tanstack/workflow-netlify

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-netlify@17

@tanstack/workflow-railway

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-railway@17

@tanstack/workflow-runtime

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-runtime@17

@tanstack/workflow-store-cloudflare-d1

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-store-cloudflare-d1@17

@tanstack/workflow-store-drizzle-postgres

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-store-drizzle-postgres@17

@tanstack/workflow-vercel

npm i https://pkg.pr.new/TanStack/workflow/@tanstack/workflow-vercel@17

commit: 3945bc9

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant